home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbmm11.zip / PCBMM.DOC < prev    next >
Text File  |  1992-10-31  |  47KB  |  1,040 lines

  1.         
  2.  
  3.  
  4.  
  5.  
  6.          ------------------------------------------------------------------
  7.         |                                                                  |
  8.         |                                                                  |
  9.         |                                                                  |
  10.         |                                                                  |
  11.         |                                                                  |
  12.         |                         PCBMM Version 1.1                        |
  13.         |                                                                  |
  14.         |                     PCBoard Multi-Menu System                    |
  15.         |                                                                  |
  16.         |                                                                  |
  17.         |                               For                                |
  18.         |                                                                  |
  19.         |                      PCBoard Version 14.5a                       |
  20.         |                                                                  |
  21.         |                                                                  |
  22.         |     Add over 100 functions to PCBoard's call-waiting screen!     |
  23.         |                                                                  |
  24.         |                                                                  |
  25.         |    Menu may also be "popped-up" anywhere in PCBoard by the       |
  26.         |    Sysop with PCBoard's built-in ALT-M local Sysop function.     |
  27.         |                                                                  |
  28.         |                                                                  |
  29.         |      Uses PCBoard's built-in hooks for the PCBMoni system.       |
  30.         |                                                                  |
  31.         |                                                                  |
  32.         |                 Highly configurable menu shell.                  |
  33.         |                                                                  |
  34.         |                                                                  |
  35.         |                                                                  |
  36.         |                                                                  |
  37.         |                                                                  |
  38.         |                                                                  |
  39.         |                                                                  |
  40.         |                                                                  |
  41.         |                         PCBMM Version 1.1                        |
  42.         |                                                                  |
  43.         |          (C) Copyright 1992   Yandell Computer Services          |
  44.         |                                                                  |
  45.         |             12121 Little Road - Bldg. 303 - Suite 212            |
  46.         |                        Hudson, FL 34667                          |
  47.         |                                                                  |
  48.         |                     DATA -- (813) 842-8099                       |
  49.         |                                                                  |
  50.         |                                                                  |
  51.         |                        October 31, 1992                          |
  52.         |                                                                  |
  53.         |                                                                  |
  54.         |                                                                  |
  55.          ------------------------------------------------------------------ 
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         --------------------------------------------------------------------
  70.                                        PCBMM
  71.         --------------------------------------------------------------------
  72.  
  73.  
  74.            
  75.                                   TABLE OF CONTENTS                     
  76.  
  77.  
  78.               INTRODUCTION                                              Page
  79.               ------------                                              ----
  80.               1.0  What Is PCBMM                                           3
  81.               1.1  Multi-Nodes, Networks, Multi-taskers                    3
  82.  
  83.    
  84.               INSTALLING PCBMM AS PCBOARD'S PCBMONI UTILITY
  85.               ---------------------------------------------
  86.               2.0  Preliminaries                                           4
  87.               2.1  Step-by-step Installation Instructions                  5
  88.               2.2  PCBMM Main Set-up Parameters (MMSETUP.EXE)            6-7
  89.               2.3  Change PCBoard Call-Waiting Screen to Say "PCBMM"       8
  90.                
  91.    
  92.               INSTALLING PROGRAMS INTO THE PCBMM SYSTEM
  93.               -----------------------------------------
  94.               3.0  Installing Programs Into PCBMM                       9-11
  95.               3.1  Re-installing PCBMONI Into PCBMM                       12
  96.               3.2  When to Use a Batch File Instead of Command Line       12
  97.               3.3  Configuring a "Drop to DOS" (shell) function           12
  98.               3.4  Memory Considerations - Swapping PCBoard               12
  99.               3.5  Sample Setup - MMUTIL1.EXE, MMUTIL2.EXE, etc.          13
  100.  
  101.  
  102.               MISCELLANEOUS
  103.               ------------- 
  104.               4.0  Technical Notes                                        14
  105.               4.1  Error Messages                                         14
  106.               4.2  Where to Receive Assistance                            14
  107.               4.3  Disclaimer and Warranty                                15
  108.               4.4  License to use PCBMM                                   15
  109.  
  110.                
  111.               REGISTRATION       
  112.               ------------
  113.               5.0  Registering PCBMM                                      16
  114.               5.1  Register with CONFIDENCE - Author Information          16
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.         --------------------------------------------------------------------
  136.         Page 3                         PCBMM                          Page 3
  137.         --------------------------------------------------------------------
  138.  
  139.         1.0  What is PCBMM
  140.         ------------------
  141.         PCBMM  adds over 100 local maintenance functions to PCBoard's  call-
  142.         waiting  screen.   These functions may also be called by  the  Sysop 
  143.         while logged LOCALLY into their systems using ALT-M.
  144.                     
  145.         PCBMM  allows the Sysop access to other functions from one, easy  to 
  146.         use central menu system.  PCBMM has been  designed to  be  installed 
  147.         into  the  PCBoard  environment where PCBMoni  usually  is  located.  
  148.         PCBMoni is then moved to the PCBMM system if desired. 
  149.  
  150.         Using PCBoard's "hooks" into the PCBMoni system allows the Sysop  to 
  151.         call  up the PCBMM system from the PCBoard call-waiting  screen,  or 
  152.         from  any PCBoard prompt while logged in locally using the ALT-M key
  153.         combination.
  154.  
  155.         Typical examples of PCBMM use:
  156.                
  157.           *  Checking caller's responses to a log-in or script questionnaire 
  158.              WHILE reading or responding to messages. This requires a simple 
  159.              text viewing program (LIST) to be installed into PCBMM.  Simply
  160.              press ALT-M *while* reading the message.
  161.           
  162.           *  Viewing CALLER logs from the PCBoard call-waiting menu  without 
  163.              logging  into the system.  This requires a  caller-log  viewing 
  164.              program such as ACTView to be installed as a PCBMM function. 
  165.  
  166.           *  Editing news, bulletins, menu, etc. files from any prompt while 
  167.              logged into PCBoard.  This requires the installation of editors 
  168.              (ones typically used for these purposes) in PCBMM. 
  169.                               
  170.           *  Your favorite off-line mail reader may be installed.
  171.                
  172.           *  Any other utilities used in the maintenance of your BBS!
  173.  
  174.           *  See the sample configuration for other examples of use.
  175.  
  176.  
  177.         1.1  Multi-nodes, networks, multi-taskers
  178.         -----------------------------------------
  179.         PCBMM has been developed in a networked environment.  All multi-node 
  180.         features are thoroughly tested on our own multi-node PCBoard system. 
  181.         
  182.         PCBMM is DESQview aware.  It is automatically detected.  Screen  and 
  183.         keyboard I/O are "well behaved". Time slices are given back to other
  184.         applications while PCBMM is idle at an input prompt.
  185.                     
  186.         DESQview is the ONLY multi-tasking software supported by PCBMM. 
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.         --------------------------------------------------------------------
  202.         Page 4                         PCBMM                          Page 4
  203.         --------------------------------------------------------------------
  204.  
  205.         2.0  Preliminaries
  206.         ------------------
  207.         To use PCBMM from PCBoard's call-waiting screen (the screen  present 
  208.         while PCBoard is ready and waiting for callers) it must be installed
  209.         in  place of PCBoard's PCBMoni utility.  PCBMoni is a utility  which 
  210.         comes  with  PCBoard and is used to monitor  activity  on  different 
  211.         node's on a single screen.   
  212.  
  213.         The PCBMoni utility may then be moved to the PCBMM system, resulting 
  214.         in no loss of use, or functionality of, the PCBMoni utility.
  215.           
  216.         PCBMoni is a file called PCBMONI.EXE.  It is probably  located  with 
  217.         your  other  PCBoard executable files (PCB145.EXE, etc.).  You  must 
  218.         locate this file and note its location.  If this file does not exist
  219.         on  your system and you do not use the PCBMoni utility, you  need to
  220.         determine a DOS path to place the PCBMM files in instead.
  221.  
  222.         In the simplest terms, PCBMONI.EXE is renamed to another name,  such 
  223.         as PCBMON.EXE.  The PCBMM files are then placed where PCBMONI is (or 
  224.         was) and PCBMM.EXE is renamed to PCBMONI.EXE.  This is  required  so 
  225.         that  the PCBMM system will run when "PCBMoni" is selected from  the 
  226.         call-waiting screen or when ALT-M is pressed while logged in locally 
  227.         to  PCBoard (Note: step-by-step instructions are given later on  how 
  228.         to change "PCBMoni" on the PCBoard call-waiting screen).
  229.  
  230.         In  all  cases, PCBMM.EXE(PCBMONI.EXE) must be in your DOS  path  in  
  231.         order to function properly when called by PCBoard.
  232.  
  233.           
  234.         Basic installation requirements:
  235.         --------------------------------
  236.   
  237.           * A basic understanding of PCBoard software and the layout of your 
  238.             bulletin board system.
  239.  
  240.           * A basic understanding of DOS path information and the DOS  paths 
  241.             in use on your system.
  242.  
  243.           * A basic understanding of DOS batch files.  Some understanding of 
  244.             passed  variables  (%1, %2)  to batch files  might  be  helpful, 
  245.             depending  on the type of applications you plan to install  into 
  246.             the PCBMM menu system.
  247.  
  248.           * A print out of this manual to use as a check-list for installing
  249.             PCBMM.
  250.                
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.         --------------------------------------------------------------------
  268.         Page 5                         PCBMM                          Page 5
  269.         --------------------------------------------------------------------
  270.  
  271.         2.1 Step-by-step installation instructions
  272.         ------------------------------------------
  273.         CAREFULLY  following  the steps below should install PCBMM  with  no 
  274.         problems.
  275.  
  276.         ____(1)  Look at your PCBoard call-waiting screen (the screen  which 
  277.         appears  while waiting for a caller).  The lower row of menu  items, 
  278.         in the center, is a menu selection that says PCBMoni. Selecting this 
  279.         calls up this excellent node monitoring program.  You must decide if 
  280.         you are going to install the PCBMM function in place of the  PCBMoni  
  281.         function,  or use PCBMM as a stand-alone utility, or both.   If  you 
  282.         replace PCBMoni, you may re-locate the PCBMoni function to the PCBMM 
  283.         selection menu if you wish.
  284.  
  285.         Installing  PCBMM in place of PCBMoni allows you to call PCBMM  from 
  286.         the  PCBoard  calling waiting screen and from  anywhere  in  PCBoard 
  287.         while  logged in locally by pressing ALT-M.  This is primarily  what 
  288.         PCBMM has been designed for.
  289.  
  290.  
  291.         ____(2) If you are going to replace PCBMoni, the PCBMM files MUST be 
  292.         placed in a directory path.  The most suitable location for this  is 
  293.         the  main \PCB directory, where PCB145.EXE and  PCBMONI.EXE  reside. 
  294.         This location is typically already in a DOS path on most systems.
  295.  
  296.         You may install the PCBMM files into their own directory (\PCBMM):
  297.         (A) If not installing PCBMM as the PCBMoni function replacement, OR
  298.         (B) If its own directory (\PCBMM) is placed in the DOS path.
  299.  
  300.  
  301.         ____(3) If replacing the PCBMoni function, find PCBMONI.EXE and then 
  302.         RENAME PCBMONI.EXE to PCBMON.EXE (or another file name you  prefer). 
  303.         >> YOU MUST DO THIS to use PCBMM with ALT-M in PCBoard!!!
  304.  
  305.         Note:  You  will  not have PCBMONI.EXE on your system  if  you  have 
  306.         previously  deleted it (if not used, etc.).  This is ok.  You simply 
  307.         will not need to install the renamed PCBMON.EXE into PCBMM (later).
  308.  
  309.  
  310.         ____(4) Extract or place ALL of the PCBMM files in the location  you 
  311.         have decided on in step #2 above.
  312.  
  313.  
  314.         ____(5) If you are replacing the PCBMoni function, copy PCBMM.EXE to 
  315.         PCBMONI.EXE (>COPY PCBMM.EXE PCBMONI.EXE) - but only after carefully 
  316.         completing  step  #3 above.  STEP #5 IS ABSOLUTELY REQUIRED  if  you 
  317.         wish to use PCBMM from the PCBoard call-waiting screen or with ALT-M 
  318.         while logged locally into PCBoard.
  319.  
  320.  
  321.         ____(6) Run MMSETUP.EXE. Select option #1, "Edit PCBMM  Main  Set-up 
  322.         parameters".  Edit each parameter as needed.  IMPORTANT: Press F1 at 
  323.         each parameter for configuration help. 
  324.  
  325.         The  "PCBMM Main Set-up parameters" are explained in detail  in  the 
  326.         next section. 
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.         --------------------------------------------------------------------
  334.         Page 6                         PCBMM                          Page 6
  335.         --------------------------------------------------------------------
  336.  
  337.         2.2 Editing PCBMM main set-up parameters (MMSETUP.EXE)
  338.         ------------------------------------------------------
  339.  
  340.         * Your PCBMM Registration Number
  341.         --------------------------------
  342.         This  is the registration number received when PCBMM is  registered. 
  343.         All  functions  are  enabled in unregistered copies.  There  is  one 
  344.         usage limitation on unregistered copies of PCBMM, which permits only  
  345.         the first 18 of the 105 menu selections to be used until registered.
  346.  
  347.         Registration will display your system name in the line near the  top 
  348.         of the PCBMM menu selection screen.
  349.  
  350.         Registration  also removes the "PCBMM [Unregistered  Copy]"  message 
  351.         and the brief delay at program termination.  
  352.  
  353.  
  354.         * PCBOARD.DAT For Stand Alone Use
  355.         ---------------------------------
  356.         A  PCBOARD.DAT  (PCBoard's main configuration file)  is  needed  for 
  357.         PCBMM  to  operate.  These files are usually found  in  each  node's  
  358.         directory, sometimes referred to as the node's "home directory". 
  359.  
  360.         PCBMM will  first look in the current directory for  PCBOARD.DAT. If 
  361.         PCBMM  has  been installed as PCBMoni and called  from  the  PCBoard 
  362.         call-waiting  screen  or  with  PCBoard's  ALT-M,  PCBOARD.DAT  will 
  363.         usually be found in the current directory.
  364.   
  365.         If PCBOARD.DAT isn't found in the current directory, the environment 
  366.         variable  PCBDAT  is checked to see if PCBOARD.DAT files  are  being  
  367.         kept elsewhere.  If so, this PCBDAT environment variable location is 
  368.         used.
  369.                                                   
  370.         If PCBOARD.DAT is not found as outlined above, then the location and 
  371.         filename entered here is used (to use PCBMM in stand-alone mode).
  372.  
  373.  
  374.         * Idle Keyboard Time-out (Minutes)
  375.         ----------------------------------
  376.         Enter the keyboard time-out (in minutes). Valid responses are 0 - 9. 
  377.         Entering a 0 zero will disable this feature. If the time-out  occurs 
  378.         while  at the main PCBMM selection menu, PCBMM will exit and  return  
  379.         to the previous application as follows: 
  380.  
  381.         If PCBMM has been selected from the PCBoard call-waiting  screen (as 
  382.         PCBMoni),  you will return to that screen, where PCBoard will  reset 
  383.         the modem and wait for a caller.
  384.   
  385.         If PCBMM has been selected with ALT-M (PCBMoni) while you are logged 
  386.         into PCBoard locally, you will be returned to the  point  where  you
  387.         selected ALT-M in PCBoard.
  388.  
  389.         If PCBMM has been executed from the DOS prompt, PCBMM will return to 
  390.         the DOS prompt if the time-out occurs.
  391.  
  392.                        Section 2.2 continues on the next page
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.         --------------------------------------------------------------------
  400.         Page 7                         PCBMM                          Page 7
  401.         --------------------------------------------------------------------
  402.  
  403.         2.2 Editing PCBMM main set-up parameters (continued)
  404.         ----------------------------------------------------
  405.  
  406.         * Remember Last Function Used
  407.         -----------------------------
  408.         If  you  answer  Yes to this parameter, PCBMM will  store  the  menu 
  409.         number of the last item which was highlighted when PCBMM ended.  The 
  410.         next  time  PCBMM is used, this menu selection will  be  highlighted 
  411.         when  the menu is first displayed.  This is useful if you are  doing 
  412.         maintenance that requires you to exit and re-enter PCBMM frequently, 
  413.         as you will not be required to move the cursor (& possibly PageDown) 
  414.         to highlight the selection every time you bring up PCBMM.
  415.  
  416.         If you answer No, PCBMM will always begin with item #1 in the  upper 
  417.         left hand corner highlighted.
  418.  
  419.         Note:  This  feature refers to saving the  highlight  location  upon 
  420.         actual termination  of PCBMM, not the calling of a PCBMM menu  item. 
  421.         When a PCBMM menu item (function) is used, that item will always  be 
  422.         highlighted upon returning to PCBMM.
  423.  
  424.         You should answer NO to this parameter if concurrent copies of PCBMM 
  425.         will be running on your system at any given time.  
  426.  
  427.  
  428.         * Password To Edit Functions With ALT-F1
  429.         ----------------------------------------
  430.         Any menu item may be quickly configured, changed, or  deleted  while 
  431.         using  PCBMM  by  simply  highlighting the  desired  menu  item  and 
  432.         pressing  the  ALT and F1 keys simultaneously. This  eliminates  the  
  433.         need to exit PCBMM, run the MMSETUP.EXE utility then re-enter PCBMM.
  434.  
  435.         This edit function may be password protected if desired. This  could 
  436.         be especially useful if PCBMM has been made available to remote  Co-
  437.         Sysops  through a remote "Doorway" type program, otherwise  an  edit  
  438.         password would probably not be needed.
  439.  
  440.         If a password for ALT-F1 editing is desired, simply enter it in this 
  441.         parameter.  If a password exists and ALT-F1 is pressed, the password 
  442.         will have to be entered. If the password is correctly entered, PCBMM
  443.         will not ask for it on subsequent ALT-F1 edits.
  444.  
  445.         Special  note  regarding  this  parameter:  While  this   "password" 
  446.         parameter may give special consideration for use of PCBMM as an  on-
  447.         line  utility  for  co-Sysops through a  "doorway"  program,  please 
  448.         remember that PCBMM has been designed as a local Sysop utility.  All
  449.         aspects  of  the functionality and performance of this  program  are 
  450.         designed with LOCAL use in mind, NOT for use as an on-line utility.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.         --------------------------------------------------------------------
  466.         Page 8                         PCBMM                          Page 8
  467.         --------------------------------------------------------------------
  468.  
  469.         2.3 Change PCBoard call-waiting screen to say "PCBMM"
  470.         -----------------------------------------------------
  471.         By  default, the bottom center menu bar on the PCBoard  call-waiting 
  472.         screen  says  "PCBMoni".  If you wish to change  this  to  correctly 
  473.         indicate the new "PCB Multi-Menu" function, follow each of the steps 
  474.         below.  The  following  instructions  presume  the  Sysop  has  some 
  475.         familiarity with customizing PCBoard's PCBTEXT files with  PCBoard's 
  476.         MKTXT145.EXE.
  477.  
  478.         These are cosmetic changes to the PCBoard call waiting screen  only. 
  479.         If PCBMM does not function, it is not due to any installation errors 
  480.         which may result from the following steps.
  481.  
  482.  
  483.           __ Run MKTXT145.EXE
  484.  
  485.           __ Edit PCBTEXT preceded by its location. If you are told the file
  486.              was not found, you are not entering the correct information.
  487.  
  488.           __ Select F3 (jump to record).
  489.  
  490.           -- Enter 515.  This is the PCBMoni menu selection bar text.
  491.  
  492.           __ Enter: "PCB Multi-Menu" (without the quotes).  If you  wish  to 
  493.              call  this process something else, enter your preference  here.  
  494.              PCBoard  will  automatically center the text you enter  in  the 
  495.              selection bar.
  496.  
  497.           __ Press F3 again.
  498.  
  499.           __ Enter 530.  This is the long description of the function which
  500.              appears under the PCBMoni menu bar on the call-waiting screen.
  501.  
  502.           -- Enter:
  503.              "Run  PCBMM (PCBoard Multi-Menu) for more maintenance  options"
  504.              (Again, don't enter the quotes). If you wish to use a different 
  505.              description, enter  your preference here.  PCBoard  will  auto-
  506.              matically center this description on the call-waiting screen.
  507.  
  508.           __ Press ESC to save the changes and exit MKTXT145.EXE
  509.  
  510.           __ Run PCBoard. Review the changes on the call-waiting screen.
  511.  
  512.  
  513.           
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.         --------------------------------------------------------------------
  532.         Page 9                         PCBMM                          Page 9
  533.         --------------------------------------------------------------------
  534.  
  535.         3.0  Installing programs into PCBMM
  536.         -----------------------------------
  537.         If all installation steps described in sections 2.0 through 2.3 have 
  538.         been  carefully  followed, you are now ready to  run  and  configure 
  539.         individual  menu  items in PCBMM.  If you are running PCBMM  as  the 
  540.         PCBMoni  function, highlight the "PCB Multi-Menu" bar on  the  call-
  541.         waiting  screen  and  press [ENTER]. If you are logged into  PCBoard 
  542.         locally, you may press ALT-M at any time from any PCBoard prompt  to 
  543.         execute PCBMM.
  544.  
  545.         To  review and configure the menu items, highlight the desired  item  
  546.         and  press ALT-F1.  You will have to enter the edit password if  one 
  547.         was  assigned during step #6 in section 2.1.  At this point, you may 
  548.         review and change the current item's configuration.  Each  parameter 
  549.         has  help  available by pressing F1 which should provide  sufficient  
  550.         details  for  configuration.  Remember that only the first  18  menu 
  551.         times may be defined until PCBMM has been registered.
  552.  
  553.         * Function Name To Appear In Menu
  554.         ---------------------------------
  555.         This  is  the name of the function which appears in  the  "selection 
  556.         bar"  on  the menu with the other menu selection bars.  This  "name" 
  557.         should be a brief description of what this function does, so that it 
  558.         can easily be identified on the selection menu. 
  559.  
  560.         For example, if you were using LIST to view the log-in questionnaire 
  561.         answer  file (NEWREG is the default PCBoard name for this file)  you 
  562.         might give this function a name such as:  View NEWREG
  563.                
  564.         The name you place in this parameter is automatically "centered"  in 
  565.         the selection bar by PCBMM, so there is no need to center this entry
  566.         on the installation screen.
  567.  
  568.         * Filename And Command Line To Execute
  569.         --------------------------------------
  570.         This is the DOS filename and command line to execute.  For instance: 
  571.             LIST.EXE D:\PCB\MAIN\NEWREG 
  572.  
  573.         would look for the filename LIST.EXE in the current directory,  then 
  574.         the DOS path. The NEWREG file (the command line) will then be shown.
  575.                                  - - -     
  576.         It is recommended to include the location of the executable filename 
  577.         in-line (preceding the executable file name) whenever possible.  For 
  578.         instance:
  579.             C:\UTIL\LIST.EXE D:\PCB\MAIN\NEWREG
  580.  
  581.         would  look  for LIST in C:\UTIL\ and execute it.  This  results  in 
  582.         faster response time since the DOS path is not searched.
  583.                
  584.         If  the  filename & command line exceed the length  allowed  in  the  
  585.         PCBMM  installation screen, or if the program to be used requires  a 
  586.         switch  to its directory, you will need to use a batch file in  this 
  587.         parameter.  See section 3.2 on page 12 for more information.
  588.  
  589.                        Section 3.0 continues on the next page
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.         --------------------------------------------------------------------
  598.         Page 10                        PCBMM                         Page 10
  599.         --------------------------------------------------------------------
  600.  
  601.         3.0  Installing programs into PCBMM (continued)
  602.         -----------------------------------------------
  603.  
  604.         * Long Description Of Function To Appear On Menu
  605.         ------------------------------------------------
  606.         When using cursor keys to highlight a selection on the menu, a  long 
  607.         description of each function will appear below the menu "grid" while
  608.         that particular function is highlighted.
  609.  
  610.         For example, if you were using LIST to view the log-in questionnaire 
  611.         answer  file (NEWREG is the default PCBoard name for this  file) you 
  612.         might give this function a long description such as:
  613.  
  614.         View the log-in NEWASK questionnaire answer file NEWREG
  615.                
  616.         The long description you place in this parameter will  automatically 
  617.         be  centered  on the screen by PCBMM, so there is no need to  center  
  618.         this  entry on the installation screen.
  619.  
  620.  
  621.         * Prompt For Additional Command Line
  622.         ------------------------------------
  623.         You may wish to install a function where the executable program name 
  624.         is always the same, but the command lines vary.  Each menu selection 
  625.         in PCBMM can be set to prompt you for additional command line infor-
  626.         mation before executing the command.  Valid settings here are: 
  627.                                    
  628.         (Y)es : Prompt for command line after selecting an item.  PCBMM will
  629.                 add  a  [SPACE] between the end of the filename  or  command 
  630.                 line and the cursor in the command line editing field.
  631.                                    
  632.         (N)o  : Do not prompt for additional command line information.
  633.  
  634.         (O)mit: Prompt for a command line after selecting an item, but  omit 
  635.                 the [SPACE] between the end of the filename or command  line 
  636.                 and the cursor in the command line editing field.
  637.  
  638.  
  639.         * Pause Before Returning To PCBMM
  640.         ---------------------------------
  641.         When  some  applications run, they display a screen  of  information  
  642.         then  exit  to the DOS prompt with no prompting from the user.  This 
  643.         type  of application is usually not well suited for use with  PCBMM, 
  644.         since the PCBMM menu screen is re-drawn when an application ends and
  645.         returns  to PCBMM (this would erase the application's screen  before  
  646.         it could be reviewed by the operator).
  647.  
  648.         Answering Yes to this parameter will cause a "Press any key"  prompt 
  649.         to  appear  at the bottom of the screen after an  application  ends, 
  650.         before PCBMM clears the screen to re-draw the menu.
  651.  
  652.         This should only be used if needed as described above.  If it is not 
  653.         needed, answer (N)o to this parameter, which is the default.
  654.  
  655.                      Section 3.0 is continued on the next page
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.         --------------------------------------------------------------------
  664.         Page 11                        PCBMM                         Page 11
  665.         --------------------------------------------------------------------
  666.  
  667.         3.0  Installing programs into PCBMM (continued)
  668.         -----------------------------------------------
  669.  
  670.         * Swap PCBMM From Memory To EMS Or Disk
  671.         ---------------------------------------
  672.         PCBMM  has the ability to SWAP itself out of memory to EMS  or  disk 
  673.         when running an application (or when simply shelling to DOS).
  674.  
  675.         Answer  Y to have PCBMM automatically detect if EMS is present,  and 
  676.         swap  itself  to EMS if available.  If EMS is not found  or  is  not 
  677.         available, PCBMM will then swap itself to disk.
  678.  
  679.         Answer D to force PCBMM to swap itself to Disk during a shell,  even 
  680.         if EMS is available.  
  681.  
  682.         Answer  N to disable swapping.  PCBMM will remain  in  memory.  This 
  683.         should be used if difficulties arise using the above modes.
  684.  
  685.         Never  use  a swap mode if PCBMM is being used  in  a  multi-tasking  
  686.         environment other than those listed as supported in this manual.
  687.  
  688.  
  689.         * Password to use this function (if needed)
  690.         -------------------------------------------
  691.         Each  function may be password protected if desired.  This could  be 
  692.         useful if PCBMM has been made available to remote Co-Sysops  through 
  693.         a remote "Doorway" type program, otherwise a password would probably 
  694.         not be needed.
  695.  
  696.         If a password for this function is desired, simply enter it in  this 
  697.         parameter.  If a password exists for this function and this function 
  698.         is selected from the menu, the password will have to be entered each 
  699.         time this function is selected from the menu.
  700.  
  701.         Each  function may have a different password, the same  password  as  
  702.         other functions, or no password at all.
  703.                                    
  704.         If the MMSETUP.EXE (Multi-Menu Setup) program has been installed  as  
  705.         a  menu  selection  and PCBMM is available to  Co-Sysops,  the  menu 
  706.         selection containing MMSETUP.EXE should be password protected.
  707.  
  708.         Special  note  regarding  this  parameter:  While  this   "password" 
  709.         parameter may give special consideration for use of PCBMM as an  on-
  710.         line  utility  for  co-Sysops through a  "doorway"  program,  please 
  711.         remember that PCBMM has been designed as a local Sysop utility.  All
  712.         aspects  of  the functionality and performance of this  program  are 
  713.         designed with LOCAL use in mind, NOT for use as an on-line utility.
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.         --------------------------------------------------------------------
  730.         Page 12                        PCBMM                         Page 12
  731.         --------------------------------------------------------------------
  732.  
  733.         3.1  Re-installing PCBMONI into PCBMM                       
  734.         -------------------------------------
  735.         The sample PCBMM.DAT file enclosed with PCBMM contains an example of 
  736.         PCBMoni installed as a function in PCBMM.  Use the filename you used
  737.         when renaming PCBMONI.EXE (PCBMON.EXE was recommended). Example:
  738.  
  739.            >D:\PCB\PCBMON.EXE D:\PCB\MAIN\USERNET.XXX
  740.  
  741.         The  above entry would be placed in the "File &  Command"  parameter 
  742.         while  using  ALT-F1 in PCBMM to edit a menu  selection.  PCBMON.EXE 
  743.         would  be located in D:\PCB, and your USERNET file would be  located 
  744.         in  D:\PCB\MAIN.  PLEASE NOTE: If you are using an early version  of 
  745.         PCBoard 14.5a, you may need to use the filename USERNET.DAT  instead 
  746.         of USERNET.XXX.
  747.           
  748.         Answer No to "Prompt for additional command line". 
  749.         Answer No to "Pause before returning to PCBMM". 
  750.         Answer No to "Swap PCBMM" unless memory is very limited.
  751.  
  752.         3.2  When to Use a Batch File Instead of Command Line
  753.         -----------------------------------------------------
  754.         If  the filename and command line for a function exceeds 60  (sixty)
  755.         characters, you will need to create a batch file which contains  the 
  756.         commands.  You would then simply place this batch file name  in  the 
  757.         "File  & Command" parameter in the function's  installation  screen.  
  758.         This  batch file must reside with PCBMM.EXE (PCBMONI.EXE).  You  may 
  759.         set the "prompt for additional command line" parameter, just be sure 
  760.         to  place %1, %2, etc. variables at the end of the command  line  in 
  761.         your batch file if you do.
  762.  
  763.         You  will  also  need to create a batch file for  any  process  that 
  764.         requires  you  to actually switch (CD\DIRNAME) to  an  application's 
  765.         directory  before  running  the application.   Simply  move  to  the 
  766.         application's  drive and directory in the batch file before  running 
  767.         it  (sort  of  like many "door" batch files).  You do  not  need  to 
  768.         switch back to the current directory (with the batch file) when  the 
  769.         application ends, as this is automatically handled by PCBMM.
  770.  
  771.         3.3  Configuring a "Drop to DOS" (shell) function 
  772.         -------------------------------------------------
  773.         To temporarily drop (shell) to the DOS prompt, enter the word  SHELL  
  774.         in  the "File & Command" parameter for an item.  To exit  from  this 
  775.         shell,  type  EXIT at the DOS prompt.  The  "Prompt  for  additional 
  776.         command  line" and "Pause before returning to PCBMM" parameters  are 
  777.         ignored when using this special shell function.
  778.  
  779.         3.4  Memory Considerations - Swapping PCBoard
  780.         ---------------------------------------------
  781.         It  may  be  necessary to run PCBoard in SWAP mode  to  free  enough 
  782.         memory  for  some  applications you might  use.   Many  systems  are 
  783.         already using the SWAP mode for other requirements.  If you are  not 
  784.         sure if you have SWAP enabled, use the enclosed MMUTIL1.EXE  utility 
  785.         (called "View PCB Switches" in the sample PCBMM Menu).  Please refer 
  786.         to  the  PCBoard  manual  for  installation  and  other  information 
  787.         regarding the /SWAP switch.
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.         --------------------------------------------------------------------
  796.         Page 13                        PCBMM                         Page 13
  797.         --------------------------------------------------------------------
  798.  
  799.         3.5  Sample Setup - MMUTIL1.EXE, MMUTIL2.EXE, etc.
  800.         --------------------------------------------------
  801.         PCBMM  comes with a sample PCBMM.DAT file that is fully loaded  with 
  802.         applications.  You may use these examples as they are, or edit  them 
  803.         to  install  your own applications in PCBMM.  The  examples  in  the 
  804.         enclosed  PCBMM.DAT  should help you get  started.  Remember,  until 
  805.         PCBMM is registered only the first 18 items may be defined or  used. 
  806.         See ORDER.FRM for details on how to register PCBMM.
  807.           
  808.         Review  the  items below, using ALT-F1 (while highlighted)  to  view 
  809.         their installation in PCBMM.
  810.  
  811.         The default PCBMM.DAT comes with MMSETUP as function number one. You
  812.         may  remove or change this.  Once the "main" PCBMM  parameters  have 
  813.         been set with MMSETUP, they should not need to be edited very often.
  814.  
  815.         The second item is an example of the SHELL command (see section  3.3 
  816.         on page 12 for details).
  817.  
  818.         The third item is an example of PCBMoni, relocated from its original 
  819.         home on the PCBoard call-waiting screen. 
  820.  
  821.         Note the method of installation of the other items and use them as a 
  822.         guideline when installing your own applications in PCBMM.
  823.  
  824.  
  825.         Descriptions of the MMUTIL1.EXE, MMUTIL2.EXE etc. files.
  826.         -------------------------------------------------------
  827.         Enclosed  with PCBMM are six small utilities which help  demonstrate 
  828.         the  PCBMM  program.  You may use these utilities as  guideline  for 
  829.         installing  other  utilities  into PCBMM.  Since some  of  them  are 
  830.         "PCBoard  specific", you may wish to leave them installed in  PCBMM. 
  831.         All six MMUTILx.EXE files are DESQview aware.
  832.                
  833.         MMUTIL1.EXE - Displays the current PCB environment switches that are 
  834.         currently set, as well as possible valid settings.
  835.           
  836.         MMUTIL2.EXE - A perpetual calendar. 
  837.  
  838.         MMUTIL3.EXE - A very simple four function calculator.
  839.           
  840.         MMUTIL4.EXE - An ASCII character chart.
  841.  
  842.         MMUTIL5.EXE - Displays all of the PCBoard @X## color macro codes.
  843.  
  844.         MMUTIL6.EXE - Displays the valid PCBoard information @ variables.
  845.  
  846.         The  MMUTILx.EXE  utilities are provided "as is"  for  demonstration 
  847.         purposes.   They may not be distributed outside of  the  PCBMM11.ZIP
  848.         compressed file.
  849.             
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.         --------------------------------------------------------------------
  862.         Page 14                        PCBMM                         Page 14
  863.         --------------------------------------------------------------------
  864.  
  865.         4.0  Technical notes
  866.         --------------------
  867.         PCBMM  has  been designed to run specifically with  PCBoard  version
  868.         14.5a.  PCBMM will not run with earlier versions of PCBoard or  with 
  869.         other brands of software.
  870.  
  871.         PCBMM uses approximately 51K of memory while running. When executing 
  872.         a  function and NOT swapping PCBMM, the amount of  available  memory 
  873.         will be reduced by this amount.  If swapping PCBMM, only 5K of PCBMM 
  874.         is left in memory.  
  875.  
  876.         If  swapping to disk (not EMS), a disk file will be created  in  the 
  877.         current  directory called PCBMMxxx.$$$.  The xxx represents the node 
  878.         number as pulled from PCBOARD.DAT.  
  879.  
  880.         While  PCBMM will share PCBMM.DAT with other nodes, care  should  be 
  881.         taken  not to edit PCBMM.DAT (with ALT-F1) while PCBMM is in use  on 
  882.         more than one node concurrently.
  883.  
  884.  
  885.         4.1  Error messages
  886.         -------------------
  887.         PCBMM  gives  verbose installation error messages for the two  files 
  888.         it  access, PCBMM.DAT and PCBOARD.DAT. If you cannot  determine  the 
  889.         error from these messages (usually invalid paths or file names)  you 
  890.         should contact YCS with the EXACT error message for assistance.  
  891.  
  892.         PCBMM  does not display error messages if an installed  function  in 
  893.         the  PCBMM menu system does not execute properly when selected  from 
  894.         the PCBMM menu.  It is up to the program being called and the  Sysop 
  895.         to track down these types of possible configuration problems.
  896.  
  897.  
  898.         4.2  Where to receive assistance
  899.         --------------------------------
  900.         Yandell  Computer  Services (YCS) provides the  following  technical 
  901.         assistance for PCBMM:
  902.           
  903.         813-842-8099   The YCS Support System.  Available to all BBS Sysops.
  904.                        INSTANT on-line credit card registration and  support
  905.                        system for YCS Shareware.  On-line 7 days  per  week, 
  906.                        24 hours per day.
  907.  
  908.         If  you need to contact YCS for installation assistance,  prepare  a 
  909.         ZIP file containing the following items prior to calling:
  910.         (1) PCBMM.DAT 
  911.         (2) PCBOARD.DAT   
  912.  
  913.         Upload this ZIP file.  Leave us a comment containing:
  914.         (1) A detailed description of your problem.
  915.         (2) The ZIP file name you uploaded (1 & 2 above).
  916.         (3) The location of your PCBOARD.DAT file on your system.
  917.         (4) The location of ALL of the PCBMM files on your system.
  918.         (5) The EXACT wording of any error messages you are receiving.
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.         --------------------------------------------------------------------
  928.         Page 15                        PCBMM                         Page 15
  929.         --------------------------------------------------------------------
  930.  
  931.         4.3  Disclaimer and warranty
  932.         ----------------------------
  933.         PCBMM is a shareware product.  PCBMM may be uploaded to BBS  systems 
  934.         as long as copyright notices are not removed and no changes are made 
  935.         to the program.  There are no warranties, expressed or implied,  for 
  936.         unregistered  copies of PCBMM.  Sysops who install  PCBMM  on  their 
  937.         systems assume any and all liabilities for anything which may result 
  938.         as a consequence of running PCBMM.  For registered copies of  PCBMM, 
  939.         Yandell  Computer  Services  warrants that  PCBMM  will  perform  as 
  940.         described in this documentation.  In the event that PCBMM  does  not 
  941.         perform  as specified, then Yandell Computer Services may  elect  to 
  942.         fix  PCBMM or refund the amount paid, if notified within 30 days  of 
  943.         registration. 
  944.  
  945.         Due  to  the type of program PCBMM is (a program which  calls  other 
  946.         programs) it is impossible to guarantee that any particular  program 
  947.         or application a Sysop might install will be compatible with  PCBMM.  
  948.         The  warranty  covering  PCBMM (in the  previous  paragraph)  covers 
  949.         PCBMM's operation only, not the operation of other programs or their 
  950.         compatibility with PCBMM.
  951.  
  952.         Under no circumstances shall Yandell Computer Services or the author
  953.         of  PCBMM  be liable for any loss of profit or  any  other  damages, 
  954.         including but not limited to special, incidental, consequential,  or 
  955.         other damages, arising out of the use or inability to use PCBMM.
  956.  
  957.  
  958.         4.4  License to use PCBMM
  959.         -------------------------
  960.         PCBMM  is not "public domain" or "free" software.  A limited license
  961.         is  granted to use and evaluate PCBMM for thirty days after  initial
  962.         installation.  PCBMM  must  be registered if it is  used  after  the
  963.         initial thirty day evaluation period.            
  964.  
  965.         A  PCBMM  registration may be used only on the  original  licensee's
  966.         BBS system and only on nodes the original licensee owns and operates 
  967.         for  their own purposes.  If the original licensee leases  or  sells 
  968.         some or all of their nodes, those nodes will require their own PCBMM 
  969.         registration.  
  970.  
  971.         PCBMM registrations are not transferable. 
  972.  
  973.         A PCBMM registration is a license to use PCBMM software on  one  (1)
  974.         BBS System at a single location with as many nodes as  the  original
  975.         licensee owns and operates at THAT location.  When the licensee owns
  976.         and operates other BBS' in other locations, each location requires a
  977.         separate PCBMM registration.
  978.  
  979.         If  PCBMM  has not been registered after 30 days, a  Sysop  reminder
  980.         will begin appearing at program termination.
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.         --------------------------------------------------------------------
  994.         Page 16                        PCBMM                         Page 16
  995.         --------------------------------------------------------------------
  996.  
  997.         5.0  Registering PCBMM
  998.         ----------------------
  999.         PCBMM is not free software. PCBMM should be registered no later than 
  1000.         30 days after installation. 
  1001.           
  1002.         Registration is $15.00 and may be paid by check, money order,  VISA, 
  1003.         Mastercard, Discover, or American Express.  If using a charge  card, 
  1004.         you may receive a registration number INSTANTLY!
  1005.           
  1006.         Refer to  the  enclosed file  ORDER.FRM  for  complete  registration 
  1007.         instructions.
  1008.  
  1009.  
  1010.         5.1  Register with CONFIDENCE - Author Information
  1011.         --------------------------------------------------
  1012.         L.  Brent  Yandell   has been programming  for  over  eleven  years, 
  1013.         including  more  than five years  of  developing  telecommunications 
  1014.         software.  Many  Sysops  will be familiar with  PCBFV,  the  popular 
  1015.         PCBoard on-line compressed file viewer; ChatBox, the popular on-line 
  1016.         PCBoard  split-screen  chat door;  QReader,  the `full-screen'  text 
  1017.         library door; PCBFX, the PCBoard file transfer profile system.
  1018.  
  1019.         Yandell Computer Services (YCS) is a  licensed  business,  operating
  1020.         and existing under the laws of the State of Florida.
  1021.  
  1022.         Writing  BBS Shareware doors and utilities, in  addition  to  custom
  1023.         programming, is our business.... our ONLY business.
  1024.  
  1025.         First Door Release: 7/6/87 (USBBSDOR) - Still updated and supported!
  1026.  
  1027.         YCS  Shareware is GUARANTEED (each product's documentation  contains 
  1028.         each product's specific guarantee).
  1029.  
  1030.         Yandell  Computer  Services is an *AUTHORIZED*  merchant  for  VISA, 
  1031.         Mastercard, Discover, and American Express charge cards.
  1032.  
  1033.         A dedicated multi-node BBS for support and on-line registrations,  a
  1034.         toll-free voice line for registrations, and a voice support line for
  1035.         registered customers are just a few of our offerings in our  efforts
  1036.         to provide you with FAST, FRIENDLY SERVICE.
  1037.  
  1038.  
  1039.  
  1040.